MINGRAPH est un logiciel de modlisation compos :
		 d'une interface (minimale) de type tableur, permettant d'entrer des donnes exprimentales ;
		 d'un interprteur (minimal) de formules, permettant d'entrer un modle thorique ;
		 d'un minimiseur, dont le principe est le mme que celui du noyau du logiciel "MINUIT" utilis au CERN (entirement rcrit en pascal, et adapt  l'interface Macintosh), et permettant d'ajuster les paramtres du modle pour reprsenter au mieux les donnes exprimentales ;
		 d'un grapheur (minimal), permettant de reprsenter graphiquement les rsultats des ajustements ;
		 la version dcrite ici est la version 2.5 d'aot 1999 ; le logiciel est compil en version "68030" sans coprocesseur (MinGraph-III_2.5) pouvant en principe fonctionner sur powerPC en mode mulation (je n'ai pas de compilateur grant le code natif des powerPC).


MENU "FICHIER"

module "donnes exprimentales"
		 lit les donnes au format texte ("TEXT") avec sparations par tabulations et retours ; enregistre ces donnes au format "TEXT" (avec suffixe de nom ".D")
		 srie de points exprimentaux dfinis par coordonnes et incertitudes (x, y, x, y), les noms des coordonnes pouvant tre redfinis en cas d'utilisation d'un modle thorique ;
		 commande-[majuscule]-retour : insre une ligne [au dessus] au dessous de la ligne courante ;
		 [majuscule]-tabulation : [recule] avance d'une colonne dans les donnes existantes ;
		 [majuscule]-retour : [recule] avance d'une ligne dans les donnes existantes ;
		 click (souris) sur une cellule existante : slection de la cellule (dition dans la case d'dition) ;
		 OK : ferme la cellule de donne s'il y en a une en cours d'dition ; sinon quitte le module des donnes ;
		 commande-OK : quitte le module mme si une cellule de donne est en cours d'dition.


module "rglage des donnes"
		 permet d'accder au module "donnes exprimentales" avec initialisation (ou modification) automatique des donnes (nombre de points, coordonnes en squence...).


module "modle thorique"
		 lit et teste les modles en format "TEXT" ; enregistre les modles en format "TEXT" (avec suffixe de nom ".F") ;
		 zone d'dition du modle : permet d'diter une formule interprtable, limite  256 caractres ;
		 pop-up menu "variable" : change le nom de variable prdfini (x) ; ou l'insre dans la formule en cours d'dition ( la position courante) ;
		 pop-up menu "modle" : change le nom du modle prdfini (y ; utilis uniquement pour l'affichage des donnes) ;
		 pop-up menu "fonctions" : dcrit les noms des fonctions reconnues par l'interprteur ; ou insre le nom de la fonction slectionne dans la formule en cours d'dition ( la position courante) ;
						 +-*/ : oprations de base (utiliser le clavier) ;
						 ^ : exposant (resource STR# 264 ; changer en $ avec ResEdit si incompatibilit avec powerPC/MacOS8) ;
						  : racine carre ;
						 signe () : signe de l'argument ;
						 abs : valeur absolue ;
						 inf(a,b) : valeur infrieure entre deux arguments ;
						 sup(a,b) : valeur suprieure entre deux arguments ;
						 ent(a) : partie entire (tronque vers zro quel que soit le signe) ;
						 mod(a,b) : valeur de  a  modulo  b  (pour b rel quelconque ; le rsultat est entre zro et |b|) ;
 					 exp : exponentielle ;
						 ln, log : logarithme nprien et logarithme dcimal ;
						 sin, cos, tan, asin, acos, atan : fonctions trigonomtriques usuelles ;
						 pH(ca',cb') : pH d'une solution d'un mlange d'acide fort et de base forte aux concentrations respectives ca' et cb' compte tenu du facteur de dilution (d au mlange) ;
						 pHaK(ca',pKa,cb') : pH d'une solution d'un mlange d'acide faible et de base forte aux concentrations respectives ca' et cb' compte tenu du facteur de dilution (d au mlange) ;
						 pHbK(ca',cb',pKa) : pH d'une solution d'un mlange d'acide fort et de base faible aux concentrations respectives ca' et cb' compte tenu du facteur de dilution (d au mlange) ;
		 pop-up menu "paramtres" : permet d'accder au module "paramtres" ; ou insre le nom du paramtre slectionn dans la formule en cours d'dition ( la position courante) ;
		 zone de commentaires de l'interprteur : pour les cas o la formule propose lui parat trange.


module "paramtres"
		 srie de paramtres ajustables du modle (normalement pas plus que 20, sauf si votre Mac est quip d'une carte CRAY...), dfinis par noms, valeurs et incertitudes ; les noms peuvant tre redfinis ; les valeurs sont considres commes constantes si l'incertitude est nulle, comme ajustables dans le cas contraire ; l'incertitude est utilise par le minimiseur pour faciliter l'ajustement (surtout dans les cas o existent plusieurs minimums) ;
		 commande-[majuscule]-retour : insre une ligne [au dessus] au dessous de la ligne courante ;
		 [majuscule]-tabulation : [recule] avance d'une colonne dans les donnes existantes ;
		 [majuscule]-retour : [recule] avance d'une ligne dans les cellules existantes ;
		 click (souris) sur une cellule existante : slection de la cellule (dition dans la case d'dition) ;
		 OK : ferme la cellule s'il y en a une en cours d'dition ; sinon quitte le module des paramtres ;
		 commande-OK : quitte le module mme si une cellule est en cours d'dition.


MENU "DITION"

module "copier"
	 copie le graphique en cours (s'il y en a un) ;
	 remarque : par ailleurs, avec un systme > 7, ce dernier active et gre automatiquement le menu "dition" (et lui seul) lors de l'utilisation d'un "dialogue modal", ce qui vite d'tre oblig d'utiliser les quivalents clavier.


MENU "MINGRAPH"

module "ajuster le modle"
		 ajuste les paramtres du modle pour minimiser "l'cart" entre le modle et les donnes exprimentales ; la minimisation peut tre interrompue (le Mac "beep" si les calculs lui semblent tranges : cycles, valeurs indfinies...) ;
		 tablit une liste (imprimable et enregistrable au format "TEXT") des valeurs initiales, des valeurs intermdiaires, et des valeurs ajustes des paramtres ;
		 peut estimer les incertitudes et les corrlations sur les valeurs ajustes, ainsi que la probabilit de l'ajustement s'il s'agit d'un chi2.


module "rglages de l'ajustement"
		 permet d'accder au module "ajuster le modle" avec initialisation particulire : les rglages sont normalement automatiques, mais ils sont accessibles pour les cas de modles compliqus ;
		 taille globale des pas : permet d'agrandir ou de rtrcir globalement la zone de recherche du minimum (sans modifier les incertitudes individuelles des paramtres) ;
		 prcision : indique au minimiseur la prcision limite au del de laquelle il est inutile de poursuivre ;
		 nombre de pas entre rsultats intermdiaires : rsultats intermdiaires pour suivre la minimisation (elle peut tre interrompue si ncessaire) ;
		 nature de "l'cart" minimis :
						 chi2 sur l'ordonne : utilise les incertitudes y (ou r, ou renommes par le modle) ;
						 chi2 sur l'abscisse et l'ordonne : utilise x et y (ou th et r...), mais en les supposant non correles ;
						 non chi2 : utiliser y = 1 (ou r = 1...) pour ajuster selon les moindres carrs ; x (ou th...) est alors ignor ; sert uniquement  viter l'affichage inutile des incertitudes et de la probabilit (qui n'ont aucun sens dans ce cas) ;
		 calcul des incertitudes : le calcul des incertitudes et des corrlations est plus dlicat que l'ajustement ; il peut tre ncessaire de le supprimer dans les cas de modles compliqus.


module "crateur de la liste"
		 permet de choisir le "crateur" de la liste rcapitulative de l'ajustement (SimpleText, MacWritePro...) ;
		 doit tre utilis AVANT d'effectuer l'ajustement (la liste est cre par un "dialogue modal" n'autorisant pas l'accs aux menus) ;
		 ne peut enregistrer les prfrences si le programme est sur un volume verrouill (les prfrences sont enregistres directement dans les ressources du programme...).


module "tracer le graphique"
		 trace le graphique (imprimable et enregistrable au format image "PICT") du modle et/ou des donnes ;
		 contrairement aux autres modules, le trac d'un graphique "active" les articles "imprimer" et "enregistrer" du menu "fichier" (inactifs  partir des autres modules, car ceux-ci sont sous forme de "modal-dialogues" et utilisent des "boutons") ; le graphique se ferme par la case de fermeture de la fentre, et cette dernire est redimensionnable et munie de barres de dfilement.


module "rglages du graphique"
		 permet d'accder au module "tracer le graphique" avec initialisation particulire : les rglages sont souvent automatiques, mais ils sont accessibles pour les cas particuliers ;
		 cadrage : automatique ou "manuel" pour les points exprimentaux, "manuel" en cas de courbe thorique seule ;
		 barres d'incertitude : peuvent tre traces ou non, avec ou non prise en compte dans le cadrage automatique ;
		 points exprimentaux : la forme et la couleur des symboles peuvent tre choisies, pour faciliter la comparaison de plusieurs sries (le regroupement peut tre fait par un logiciel graphique au format "PICT") ;
		 chelles logarithmiques : le graphique peut tre trac avec chelles logarithmiques ou semi-logarithmiques ;
		 cadrage du zro : en mode de cadrage automatique, on peut imposer le cadrage de l'origine de l'abscisse et/ou de l'ordonne (cadrage de l'unit en mode logarithmique) ;
		 courbe thorique : peut tre trace ou non, avec ou non prise en compte dans le cadrage automatique.


module "format du graphique"
		 le format du graphique est rglable :
						 on peut choisir un format "standard" (410x235 ; d'aprs l'cran de base 9 pouces), ou "A4-portrait" ("A4-vertical"), ou "A4-paysage" ("A4-horizontal") ;
						 on peut choisir un format personnalis, en pixels ou en centimtres, mais il y a des limitations (automatiques) en largeur et en hauteur (d'aprs les formats A4) ;
						 le logiciel garde en mmoire le dernier format choisi (format "usuel") ;
						 on peut toujours utiliser un logiciel graphique au format "PICT" pour modifier ;
		 pour imprimer le graphique, il faut choisir un format d'impression adapt au format de graphique choisi (c'est indpendant) ;
		 les prfrences ne peuvent tre enregistres si le programme est sur un volume verrouill (les prfrences sont enregistres directement dans les ressources du programme...).


module "type de coordonnes"
		 permet de choisir les coordonnes cartsiennes ou polaires  l'aide d'un sous-menu (les coordonnes sont initialement supposes cartsiennes) ; toutefois, bien que dj assez efficace, ce module n'est pas totalement oprationnel (les graphiques en coordonnes polaires dessinent mal les barres d'incertitudes et tracent mdiocrement certaines courbes...).


module "crateur du graphique"
		 permet de choisir le "crateur" du graphique (SuperPaint, MacDr	aw...) ;
		 peut tre utilis avant ou aprs le trac du graphique (celui-ci est cr dans une fentre autorisant l'accs aux menus) ;
		 ne peut enregistrer les prfrences si le programme est sur un volume verrouill (les prfrences sont enregistres directement dans les ressources du programme...).